home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / mgif42b.zoo / mgif.1 next >
Text File  |  1993-07-02  |  13KB  |  320 lines
  1. NAME
  2.    mgif - display colour images in grey scales and manipulate them
  3.  
  4. SYNOPSIS
  5.    mgif -fl [-m] file.fl ...
  6.    mgif [flag] ... wildcard ...
  7.       flags: -x, -xx, -n, -i, -v, -vers, -c, -w, -p, -p0 n, -p1 n, -h
  8.  
  9. DESCRIPTION
  10.    MGIF 4.2 displays colour images in four grey scales in any of the ST and
  11.    Falcon030 bitplane modes, and probably the TT modes as well, using a
  12.    flickering technique and Floyd-Steinberg dithering to get fantastic
  13.    results. In the Falcon true colour mode 32 grey scales are shown, with
  14.    dithering, which looks even better.
  15.    For best results at least 640x400 pixels at 60Hz is recommended.
  16.    A selection of image processing tools can be aplied to the image to
  17.    enhance it or produce interesting effects.
  18.  
  19.    Versions up to 3.7 of this program were written by Bill Rosenkranz, but
  20.    development is now continued by Johan Klockars.
  21.  
  22.    The currently supported image file formats are:
  23.  
  24.       GIF  - extension .GIF             (GIF87a and GIF89a)
  25.       JPEG -   - " -   .JPG or .JPE     (only the JFIF file format)
  26.       PI1  -   - " -   .PI1
  27.       PI2  -   - " -   .PI2
  28.       FL   -   - " -   .FL              (this is MGIF's own format)
  29.  
  30. OPTIONS
  31.    -x    Use extra JPEG colour decoding steps to get better results.
  32.          Without this option a faster grey scale decoding is used.
  33.          This option has no useful effect in this monochrome only version.
  34.  
  35.    -xx   The same as -x
  36.  
  37.    -n    Do not use dithering in JPEG decoding process.
  38.          This option has no useful effect in this monochrome only version.
  39.  
  40.    -i    Inquire about the files but do not display them.
  41.          Ouput contains information like image size, number of bits per
  42.          pixel etc.
  43.  
  44.    -v    Show verbose messages.
  45.  
  46.    -vers Show MGIF version information.
  47.  
  48.    -c    Do not copy image from the flicker screens to the normal screen at
  49.          return to command line mode. Very useful when you run mgif from a
  50.          window, such as MiNT/toswin or gemini/mupfel.
  51.  
  52.    -w    Wait for key at startup. Useful if you run mgif from floppy and want
  53.          to change disk before loading begins.
  54.  
  55.    -p    Use pipe for command input instead of the usual interaction.
  56.          This is not yet functional.
  57.  
  58.    -p0 n Allocate n Kb memory for the original picture.
  59.          The default is about one third of the available memory, but not
  60.          more than 1 Mb.
  61.  
  62.    -p1 n Allocate n Kb memory for the new picture.
  63.          The default is about one third of the available memory, but not
  64.          more than 2 Mb.
  65.  
  66.    -h    Show help text.
  67.  
  68.    -fl   Load files in MGIF's own flicker file format. If not the -m option
  69.          is used, the pictures are shown sequentially.
  70.          Press any key to go to the next file.
  71.  
  72.    -m    Create a mosaic of flicker files. Several images can be displayed
  73.          on one screen if they are all small enough.
  74.          Two 320x400, four 320x200 or six 200x200 images are displayed
  75.          together. Other sizes are treated as the nearest larger size.
  76.  
  77.  
  78.    wild  One or more standard wildcards with extensions as above. If a file
  79.    card  has no extension it will be treated as if it was a GIF image.
  80.  
  81. INTERACTIVE COMMANDS
  82.    The following commands are available at the prompt:
  83.  
  84.    Control Commands
  85.  
  86.       h     Help
  87.             Prints a brief summary of the available commands.
  88.  
  89.       q     Quit
  90.             Move to the next image given on the command line. If there
  91.             are no more the program exits.
  92.  
  93.       <ESC>
  94.             Exits the program.
  95.  
  96.       <SPACE>
  97.             Draws the current image.
  98.  
  99.       <ENTER>
  100.             Shows last drawn image again.
  101.  
  102.       w     What
  103.             Displays information about image, buffers, load time etc.
  104.  
  105.       hi    Histogram
  106.             Plots the intensity histogram of the current image.
  107.  
  108.       o     Toggle Original
  109.             Toggle the current image, original/new.
  110.             Transformations are cumulative only if "new" is current.
  111.  
  112.       f     File Operations
  113.             The only available file operation is to save the last screen
  114.             image to a special file having the .FL suffix. This file
  115.             will contain the three screen images which are used by the
  116.             flicker routine to simulate grey scale.
  117.             In order to save an image in this format you must first
  118.             display it completely by the flicker routine, ie do not
  119.             escape the actual screen draw but let it finish.
  120.  
  121.       cp    Copy
  122.             Copy the new, transformed image, to the original or the
  123.             other way around. The former is the most useful.
  124.  
  125.       Display Options
  126.  
  127.       n     Noise
  128.             Adds noise. Not to the image itself but to the dithering
  129.             process. This can help in images which have artificial
  130.             banding as a result of the dithering process. You are asked
  131.             for a value which is a percentage (0 to 100).
  132.             Each time "o" is toggled, noise is reset zo zero (off).
  133.  
  134.       g     Laplace filter
  135.             This, like noise, is not applied to the image itself but
  136.             rahter in the dithering process. It helps to define hard
  137.             edges in images and implements a Laplace filter. A
  138.             quantity, Beta, is required. A value of one corresponds to
  139.             a Beta of 0.25, a value of two corresponds to a Beta of 0.50
  140.             etc. A value of zero turns off Laplace filtering.
  141.             It is possible to get the same effect by giving a suitable
  142.             matrix to the convolution function.
  143.             Beta is reset to zero when "o" is toggled.
  144.  
  145.       Frame Processes
  146.  
  147.       e     Enlarge
  148.             Enlarges images two times. You can choose which dimensions
  149.             should be enlarged as either horizontal, vertical or both.
  150.             The new pixels inserted are given the average intensity of
  151.             their neighbours.
  152.  
  153.       s     Shrink
  154.             Reduces images two times. You can choose which dimensions
  155.             should be reduces as either horizontal, vertical or both.
  156.             Every other point is thrown away when reducing.
  157.  
  158.       z     Zoom
  159.             Use the arrow keys to move around a window covering one
  160.             fourth of the picture to choose which part to enlarge two
  161.             times. The shift keys can be used to position the window
  162.             with pixel accuracy. When you are satisfied, press the
  163.             <INSERT> key. At any time any other key aborts zooming.
  164.  
  165.       cu    Cut
  166.             Cuts out a rectangular area of the image.
  167.             A crosshair can be moved around as described under "zoom"
  168.             above to select first the top left corner and then the
  169.             bottom right corner. Selection is by the <INSERT> key.
  170.             The crosshair can be moved outside the screen area if the
  171.             complete image is too large to fit on screen. The coordinates
  172.             shown on screen will still show the correct values, but the
  173.             crosshair itself will of course not be visible. 
  174.  
  175.       r     Rotate
  176.             Rotate the original (not the new) image any integer angle, from
  177.             -180 to 180 degrees, counter clockwise. Any changes done to the
  178.             new image are lost, so you'll be asked to confirm the operation
  179.             if the new image is the current one.
  180.  
  181.       mi    Mirror
  182.             You can mirror the image horizontally or vertically.
  183.  
  184.       x     Shear (not shown on help screens)
  185.             Shear image horizontally or vertically a specified amount.
  186.             This is not really documented yet.
  187.  
  188.       y     Scale (not shown on help screens)
  189.             Scale image horizontally or vertically to a specified size.
  190.             This is not really documented yet.
  191.  
  192.       Point Processes
  193.  
  194.       hi    Histogram equalization
  195.             This operation attempts to smooth out images with skewed
  196.             or narrow histograms. The intensity values are redistributed
  197.             to match their occurence frequency.
  198.  
  199.       i     Inversion
  200.             This is a bit mo